package com.ruoyi.exen.common.service;

import com.jcraft.jsch.SftpException;
import com.ruoyi.exen.common.domain.SelfFile;
import org.springframework.web.multipart.MultipartFile;

import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.List;

/**
 * 【文件】Service接口
 * 
 * @author ruoyi
 * @date 2023-08-22
 */
public interface ISelfFileService
{

    /**
     * 查询【请填写功能名称】
     *
     * @param id 【请填写功能名称】主键
     * @return 【请填写功能名称】
     */
    public SelfFile selectFileById(String id);

    /**
     * 查询【请填写功能名称】列表
     *
     * @param selfFile 【请填写功能名称】
     * @return 【请填写功能名称】集合
     */
    public List<SelfFile> selectFileList(SelfFile selfFile);

    /**
     * 新增【请填写功能名称】
     *
     * @param selfFile 【请填写功能名称】
     * @return 结果
     */
    public int insertFile(SelfFile selfFile);

    /**
     * 修改【请填写功能名称】
     *
     * @param selfFile 【请填写功能名称】
     * @return 结果
     */
    public int updateFile(SelfFile selfFile);

    /**
     * 批量删除服务器文件及数据库数据
     *
     * @param ids 需要删除的文件ID
     * @return 结果
     */
    public void deleteFileByIds(List<String> ids);

    /**
     * 删除【请填写功能名称】信息
     *
     * @param id 【请填写功能名称】主键
     * @return 结果
     */
    public int deleteFileById(String id);

    /**
     *  保存文件信息
     * @param selfFile
     * @return
     */
    String saveFile(SelfFile selfFile);

    /**
     * 通过Id 获取 文件信息
     * @param id
     * @return
     */
    SelfFile findFileById(String id);

    /**
     * 更新下载次数
     * @param id
     * @param downCounts
     */
    void updateFileDownCounts(String id, Integer downCounts);

    /**
     * 上传文件功能
     * @param file
     * @return
     * @throws Exception
     */
    String upload(MultipartFile file,String pathType) throws Exception;

    /**
     * 下载文件接口
     * @param id
     * @param openStyle
     * @throws IOException
     * @throws SftpException
     */
    public void download(String id, String openStyle,HttpServletResponse response) throws IOException, SftpException;

    /**
     * 从服务器删除文件接口
     * @param id 项目ID
     * @return
     */
    void deleteServerFile(String id) throws SftpException;

    /**
     * 获取该文件的访问路径
     * @param id
     * @return
     */
    String getFileUrl(String id);
}
